﻿<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
	<head>
		<title>Документация к программе</title>
	</head>
	<body style="font-family:Tahoma">
	<h3 style="text-align: center">Ещё одна программа для чтения Палийского Канона :-)</h3>
	<h2 style="text-align: center">Идея</h2>
<p>На создание этой программы меня вдохновили три имеющиеся, работа по которым прекращена 
    их разработчиками:</p>	
        <ol>
            <li>Pali Text Reader (<a href="http://palireader.sourceforge.net/">http://palireader.sourceforge.net/</a>)</li>
            <li>Chattha Sanghayana Tipitaka 4.0 (<a href="http://www.tipitaka.org/cst4">http://www.tipitaka.org/cst4</a>)</li>
            <li>Digital Pali Reader (<a href="http://sourceforge.net/projects/digitalpali/">http://sourceforge.net/projects/digitalpali/</a>)</li>
        </ol>

	    <h2 style="text-align: center">Системные требования</h2>
	    <ol>
            <li>Windows XP или старше (Vista, Windows 2003, Windows 7)</li>
            <li>Microsoft .NET Framework 2.0</li>
            <li style="color: #0066FF">Microsoft SQL Server Compact 3.5 SP1</li>
            <li>50 мб дискового пространства, если поиск по Канону не будет использоваться, около 170 мегабайт в противном случае</li>
        </ol>
	<h2 style="text-align: center">Установка</h2>
	<p>Программа распространяется по лицензии GNU GPL v2. Ознакомиться с текстом лицензионного 
        соглашения на русском языке вы можете 
        <a href="http://law.bugtraq.ru/freesoft/gplrus3.html">здесь</a>. При попытке скачать программу с сайта, а также в процессе установки, вам будет предложено принять 
        то же самое лицензионное соглашение (на англ. языке).</p>
	
	<p>Для установки программы необходимо скачать два файла: установщик программы и 
        библиотеку. Ссылки на версии того и другого будут публиковаться здесь:
        <a href="http://palitextreader.codeplex.com/Release/ProjectReleases.aspx">
        http://palitextreader.codeplex.com/Release/ProjectReleases.aspx</a>.
        <br />
        В правой панели Releases нажмите на ссылку &quot;Pali Text Reader App v1.2&quot; и в 
        открывшейся странице нажмите на ссылку PTR2Install.zip - вам будет предложено 
        лицензионное соглашение, нажмите &quot;I Agree&quot; и вам будет предложено сохранить файл 
        на диск.
        <br />
        Для скачивания библиотеки нажмите на ссылку &quot;Pali Canon Library v1.0&quot; и 
        проделайте те же самые операции для сохранения файла на диск. </p>
        <p>Для установки программы необходимо иметь права администратора на компьютере. Для 
            работы с установленной программой права администратора не требуются.</p>
        <p><b>Установка библиотеки с Каноном</b></p>
        <p>
            Запустите файл LibraryInstall.msi - появится окно установщика, нажмите Next. 
            Далее будет предложено выбрать папку для установки. Библиотеку можно установить 
            в любую папку, но убедитесь, что на диске достаточно места, если вы планируете 
            использовать поиск. Нажмите Next и библиотека будет установлена.</p>
        <p>
            Если в <a href="http://technet.microsoft.com/ru-ru/library/cc780702(WS.10).aspx">
            соответствии с рекомендациями Microsoft</a> вы не работаете постоянно под 
            учётной записью администратора, то необходимо дать на папку с библиотекой права 
            на запись тому пользователю, от имени которого вы работаете.</p>
        <p>
            <b>Установка программы</b></p>
        <p>
            Извлеките из архива PTR2Install.zip два файла в отдельную папку и запустите setup.exe. 
            Появится окно установщика, нажмите Next. Если ваш компьютер подключён к 
            интернету и на нём не установлен MS SQL Server Compact 3.5 SP1, то установщик 
            сам скачает и установит его с сайта Microsoft, по окончании установки вам будет 
            предложено согласиться с лицензионным соглашением на эту программу (нажмите 
            Agree) и установка будет продолжена. </p>
        <p>
            Следующим шагом будет принятие лицензионного соглашения - выберите I Agree и 
            нажмите Next.</p>
        <p>
            Будет предложено выбрать папку для 
            установки - можно согласиться с предлагаемой по умолчанию или выбрать другую. 
            Нажмите Next и мастер установит программу.
            <br />
            Если компьютер, на который вы устанавливаете программу, не имеет доступа в 
            интернет, то вам необходимо заранее установить MS SQL Server Compact вручную с
            <a href="http://www.microsoft.com/downloads/details.aspx?FamilyID=dc614aee-7e1c-4881-9c32-3a6ce53384d9&amp;displaylang=ru">
            сайта Microsoft</a>. </p>
<h2 style="text-align: center">Запуск программы</h2>            
	    <p>
            После установки программы и библиотеки вы можете запустить программу, нажав на 
            ярлык PaliTextReader2 в меню &quot;Пуск&quot; - &quot;Все программы&quot;.
        </p>
<h2 style="text-align: center">Работа с программой</h2>
        <p>В главном окне программы отображается панель инструментов и рабочая область. На 
            панели инструментов расположены кнопки, с помощью которых осуществляется доступ 
            к различным операциям, в рабочей области отображается текст из книг Канона.</p>
        <p><b>Открытие и закрытие книг</b></p> 
	    <p>
            Нажмите кнопку <i>Open book</i> на панели инструментов. Появится диалоговое окно 
            с четырьмя вкладками.</p>
        <p>
            На вкладке <i>Contents</i> вы можете, разворачивая узлы дерева просматривать 
            перечень книг Канона и их содержимое. Выбрав нужную книгу в дереве нажмите OK и 
            в рабочей области программы будет открыта требуемая книга. Если вы выбрали сутту 
            или другой заголовок внутри книги, то программа сразу подведёт позицию прокрутки 
            к требуемой сутте или заголовку.</p>
        <p>
            На вкладке S<i>earch names</i> вы можете найти нужную сутту или заголовок по 
            названию. Для этого необходимо ввести название или его часть в текстовое поле и 
            нажать кнопку Find. По умолчанию поиск идёт по совпадению с начала названия 
            (переключатель в положении Starting with), но поскольку заголовки часто бывают 
            нумерованными, т.е. начинаются с числа, можно перевести переключатель в 
            положение Contains для поиска совпадений с любой частью названия.
            <br />
            Если в результате поиска были найдены совпадения, они будут выведены в список 
            под текстовым полем. Для открытия книги (сутты, фрагмента), необходимо выбрать 
            её в списке и нажать ОК. Под списком отображается местонахождение выбранного 
            элемента в иерархии.<br />
            Для поиска без учёта диакритики поставьте галочку &quot;ignore pali diacritics&quot;.</p>
        <p>
            На вкладке <i>Go To PTS Page</i> вы можете, зная название книги, номер тома и 
            страницы в PTS издании, открыть это место. Выберите название книги в списке PTS 
            Book, после чего вы сможете выбрать том (Volume) и страницу (Page). Нажмите ОК и 
            в рабочей области будет открыта требуемая книга на заданной вами странице.</p>
        <p>
            На вкладке <i>Bookmarks</i> отображаются установленные вами закладки. Для 
            открытия закладки выберите её в списке и нажмите ОК. Для редактирования имени 
            закладки или её удаления вы можете нажать кнопку Edit Page или Delete соответственно.</p>
        <p>
            На вкладке <i>Recent Books</i> отображаются недавно закрытые вами книги. Их можно снова 
            открыть на том месте, где вы их закрыли, для этого выберите книгу в списке и 
            нажмите ОК.</p>
        <p>
            Книги открываются в рабочей области программы. У каждой книги есть свой ярлык в 
            нижней части, позволяющий переключаться к ней. При наведении указателя мыши на 
            ярлык отображается подсказка с местонахождением книги в каноне.</p>
        <p>
            Закрытие книги осуществляется нажатием на красный крестик слева от её названия 
            на ярлыке.
        </p>
        <p>
            <b>Работа со словарём</b></p>
        <p>
            Во время работы с текстом можно воспользоваться поиском по словарю дост. 
            Буддхадатты. Для поиска в словаре можно выделить в тексте нужный фрагмент или 
            слово и нажать на нём правой клавишей мыши. В контекстном меню нужно выбрать 
            Lookup word, в результате чего появится панель словаря, в которой будет выполнен 
            поиск.<br />
            <br />
            Поиск выполняется по совпадению с начала термина, сам термин можно редактировать 
            и выполнять поиск заново (кнопка Find или клавиша Enter, когда курсор находится 
            в поле термина). Найденные слова отображаются в списке, 
            перевод выбранного в списке слова - в поле с правой стороны.</p>
        <p>
            История поиска отображается на вкладке History, что позволяет вернуться к 
            словам, которые вы смотрели.<br />
            <br />
            Для поиска без учёта диакритики поставьте галочку &quot;ignore pali diacritics&quot;.
        </p>
	    <p>
            Включение и выключение показа словаря осуществляется кнопкой &quot;Toggle dictionary&quot; 
            на панели инструментов.</p>
        <p>
            Для добавления слов в словарь нажмите правой клавишей мыши в любом месте на 
            вкладке Search Results словаря. В контекстном меню выберите Add term. В 
            диалоговом окне введите название термина и перевод.</p>
        <p>
            Для редактирования или удаления термина из словаря выберите слово в списке 
            Search Results и нажмите на нём правой клавишей мыши. В контекстом меню выберите 
            Edit term или Delete Term соответственно.</p>
        <p>
            <b>Работа с открытой книгой</b></p>
        <p>
            Навигация по открытой книге осуществляется с помощью диалогового окна, 
            открываемого по нажатии кнопки &quot;Book navigation&quot; на панели инструментов. На 
            вкладке contents вы можете просмотреть иерархию заголовков и быстро перейти к 
            нужному, выбрав его и нажав ОК. Можно также воспользоваться вкладкой Go To PTS 
            Page для перехода к нужной странице PTS издания.</p>
        <p>
            Поиск текста в открытой книге осуществляется с помощью стандартного диалога 
            поиска в веб-странице, вызываемого по нажатии кнопки &quot;Search in this book&quot; на 
            панели инструментов. Выводится стандартный диалог поиска по странице MS Internet 
            Explorer.</p>
        <p>
            Можно установить закладку на текущую позицию в открытой книге, для этого нажмите 
            на панели инструментов кнопку &quot;Bookmark this page&quot;. Откроется диалог, в который 
            нужно ввести название закладки (в произвольной форме) и нажать ОК. Вы сможете 
            вернуться к закладке через диалоговое окно Open Book, вкладка Bookmarks.</p>
        <p>
            Закладки в текущей книге отображаются на вкладке &quot;</p>
        <p>
            Внешний вид книги (гарнитура, размер и цвет шрифта) можно изменить, 
            отредактировав файл style.css, лежащий в папке, куда была установлена программа.</p>
        <p>
            <b>Поиск по Канону</b></p>
        <p>
            Для перехода в режим поиска нажмите на панели инструментов кнопку Search 
            tipitaka. Введите искомое слово или фразу в текстовое поле и нажмите Find. Если поиск выполняется первый раз после установки программы, будет 
            предложено создать поисковый индекс. Создание индекса выполняется 1 раз и 
            занимает несколько минут. На запрос о создании индекса нажмите Yes, программа 
            выведет диалоговое окно, в котором будет показан ход индексирования. Вы можете 
            прервать этот процесс, нажав кнопку Cancel.</p>
        <p>
            По умолчанию поиск выполняется по всем книгам Типитаки (фильтр в положении &quot;&lt;All 
            books&gt;&quot;), однако вы можете сузить диапазон поиска, выбрав книгу в списке справа 
            от кнопки Find.</p>
        <p>
            Если поиск дал результаты, то в списке слева будут выведены названия книг, в 
            которых были обнаружены совпадения. Выбранная в этом списке книга будет 
            отображена в правой панели. Под списком найденных книг отображается 
            местонахождение выбранной книги в иерархии и количество найденных в ней 
            совпадений.</p>
        <p>
            По умолчанию книга открывается полностью, а совпадения в ней подсвечиваются 
            жёлтым цветом. Вы можете переходить по совпадениям с помощью навигационных 
            кнопок. Такой вывод результатов соответствует положению переключателя &quot;Show 
            entire document&quot;.<br />
            Также возможен вывод результатов в виде дайджеста - это соответствует положению 
            переключателя &quot;show fragments&quot;. Можно указать максимальный размер элемента 
            дайджеста (по умолчанию 500 символов).</p>
        <p>
            По умолчанию система ищет точное совпадение слова или фразы. Можно пользоваться 
            подстановочными символами ? и *.
            <br />
            ? заменяет один символ, * - несколько символов. Если требуется искать совпадение 
            с любой частью слова, нужно использовать звёздочку в начале и в конце слова, 
            например *buddh*.</p>
        <p>
            Если дважды щёлкнуть по книге в списке найденных книг, она откроется в новом 
            окне.</p>
        <p>
            Возможен поиск без учёта диакритики. Для выполнения такого поиска установите 
            флаг &quot;ignore pali diacritics&quot;. В этом режиме система может искать только одно 
            слово (не фразу). По умолчанию ищутся точные совпадения, т.е. слово целиком. Для 
            поиска совпадений с любой частью слова нужно использовать звёздочку в начале и в 
            конце слова, например *buddh*.</p>
        <p>
            <b>Поиск по словарю Pali Text Society Pali-English Dictionary</b></p>
        <p>
            Для поиска по словарю нужно в списке справа от кнопки Find выбрать 
            &quot;&lt;Pali-English Dictionary&gt;&quot;. Принципы поиска те же, в списке найденных книг 
            отображаются буквы, в статьях которых найдены совпадения. При первом 
            использовании словаря будет предложено провести его индексирование. Для запуска 
            этого процесса в ответ на запрос программы нажмите Yes.</p>
        <p>
            <b>Ввод палийских символов</b></p>
        <p>
            Палийские символы, отсутствующие в стандартной латинице можно вводить с помощью 
            следующих сочетаний клавиш:</p>
        <p>
            Alt + a, i, u, d, t, l, m, n = ā, ī, ū, ḍ, ṭ, ḷ, ṃ, ṇ<br />
            Alt + g = ṅ<br />
            Alt + j = ñ</p>
        <p>
            <b>Выход из программы</b></p>
        <p>
            Для выхода из программы нажмите на панели инструментов кнопку Exit. При этом 
            сохраняется состояние всех открытых книг и при следующем запуске они будут 
            открыты заново на том месте, где они были перед закрытием.</p>
 <h2 style="text-align: center">Об авторе</h2>
	    <p>
            Программу разработал мирянин Кхантибало, Москва, 2009-2010 год. контакт: 
            khantibalo AT live.ru<br />
            Сайт программы: <a href="http://palitextreader.codeplex.com/">
            http://palitextreader.codeplex.com/</a></p>
	</body>
</html>